All Databases
Inside Mac - Basic Toolbox
ResError
AddResource
RmveResource
GetResource
ResError
Find if an error occurred in a resource operation
#include <
Resources.h
>
Resource Manager
short
ResError
(
);
returns
an
Error Code
from last operation (0=no error)
All resource-related functions store a result code in a low-memory global.
You can use
ResError
to read that code and see if the most recent operation
caused an error, and if so, what the error was.
Returns
: an integer; the
Error Code
of the most recent resource-related
operation. It may be a file system error or one of the following
resource error constants:
noErr (0) No Error (this constant is defined in MacTypes.h)
resNotFound (-192) Resource not found
resFNotFound (-193) Resource file not found
addResFailed (-194) AddResource failed
rmvResFailed (-196) RmveResource failed
(-197) (not used)
resAttrErr (-198) Attribute does not permit operation
mapReadErr (-199) Error reading
resource map
Notes:
ResError
is functionally equivalent to reading the low-memory global,
ResErr
; i.e., the following are the same, except the latter generates less
code and is faster:
if (
ResError
() ) { ... an error occurred ... }
if (
ResErr
) { ... an error occurred ... }
ResError
may return other system errors, for instance,
dskFulErr
or
memFullErr
. See
Error Codes
for a full list.
A few
Resource Manager
functions indicate errors by returning a NIL
handle (e.g.,
GetResource
). When these calls fail,
ResError
returns
noErr
, so
be sure to check for NIL handles!
Referenced by (107):
AddResource
ChangedResource
CloseResFile
DetachResource
FSpCreateResFile
FSpOpenResFile
Get1IndResource
Get1NamedResource
Get1Resource
GetIndResource
GetNamedResource
GetResAttrs
GetResFileAttrs
GetResInfo
GetResource
HCreateResFile
HOpenResFile
HomeResFile
LoadResource
OpenRF
OpenRFPerm
OpenResFile
Poor Man's Search Path
RGetResource
ReadPartialResource
ReleaseResource
RmveResource
RsrcMapEntry
SetItemIcon
SetResFileAttrs
SetResInfo
SetResourceSize
SizeResource
UpdateResFile
UseResFile
Using the Resource Manager
WritePartialResource
WriteResource
J Authors (MacTech Index)
J Topics (MacTech Index)
R Topics (MacTech Index)
Vol 11 Issues (MacTech Index)
Calling a Code Resource (Inside Mac - Index)
Resource Mgr (Inside Mac - Index)
VIA (Inside Mac - Index)
wrUnderrun (Inside Mac - Index)
AddResource (Inside Mac - Basic Toolbox)
ChangedResource (Inside Mac - Basic Toolbox)
CloseResFile (Inside Mac - Basic Toolbox)
DetachResource (Inside Mac - Basic Toolbox)
FSpCreateResFile (Inside Mac - Basic Toolbox)
FSpOpenResFile (Inside Mac - Basic Toolbox)
Get1IndResource (Inside Mac - Basic Toolbox)
Get1NamedResource (Inside Mac - Basic Toolbox)
Get1Resource (Inside Mac - Basic Toolbox)
GetIndResource (Inside Mac - Basic Toolbox)
GetNamedResource (Inside Mac - Basic Toolbox)
GetResAttrs (Inside Mac - Basic Toolbox)
GetResFileAttrs (Inside Mac - Basic Toolbox)
GetResInfo (Inside Mac - Basic Toolbox)
GetResource (Inside Mac - Basic Toolbox)
HCreateResFile (Inside Mac - Basic Toolbox)
HOpenResFile (Inside Mac - Basic Toolbox)
HomeResFile (Inside Mac - Basic Toolbox)
LoadResource (Inside Mac - Basic Toolbox)
OpenRF (Inside Mac - Basic Toolbox)
OpenRFPerm (Inside Mac - Basic Toolbox)
OpenResFile (Inside Mac - Basic Toolbox)
Poor Man's Search Path (Inside Mac - Basic Toolbox)
RGetResource (Inside Mac - Basic Toolbox)
ReadPartialResource (Inside Mac - Basic Toolbox)
ReleaseResource (Inside Mac - Basic Toolbox)
RmveResource (Inside Mac - Basic Toolbox)
RsrcMapEntry (Inside Mac - Basic Toolbox)
SetItemIcon (Inside Mac - Basic Toolbox)
SetResFileAttrs (Inside Mac - Basic Toolbox)
SetResInfo (Inside Mac - Basic Toolbox)
SetResourceSize (Inside Mac - Basic Toolbox)
SizeResource (Inside Mac - Basic Toolbox)
UpdateResFile (Inside Mac - Basic Toolbox)
UseResFile (Inside Mac - Basic Toolbox)
Using the Resource Manager (Inside Mac - Basic Toolbox)
WritePartialResource (Inside Mac - Basic Toolbox)
WriteResource (Inside Mac - Basic Toolbox)
Using the High-Level Interface (Inside Mac - DAM-Ed-PPC-Slot)
Resource Editors (MacTech Vol 02-1986)
Icon Reader (MacTech Vol 03-1987)
Smart Docs (MacTech Vol 04-1988)
Aug 89 Letters (MacTech Vol 05-1989)
Doodats (MacTech Vol 05-1989)
Help for Help (MacTech Vol 05-1989)
Apr 92 Mousehole (MacTech Vol 08-1992)
Executing Code (MacTech Vol 10-1994)
Apr 95 Dialog Box (MacTech Vol 11-1995)
Diet For Fats (MacTech Vol 11-1995)
Execute OSAs (MacTech Vol 11-1995)
Guide Extrn Code Modules (MacTech Vol 11-1995)
Jasik ResError (MacTech Vol 11-1995)
Jul 95 Tips (MacTech Vol 11-1995)
Nov 96 Tips (MacTech Vol 12-1996)
Registration Tool (MacTech Vol 12-1996)
Spotlight-Illuminate Bugs (MacTech Vol 13-1997)
Jul 99 Getting Started (MacTech Vol 15-1999)
Summer 91 - MACINTOSH Q & A (develop - 1991)
March 93 - ADVENTURES IN COLOR PRINTING (develop - 1993)
June 96 - According to Script: Attaching and Embedding Scripts (develop - 1996)
March 96 - Using C++ Exceptions in C (develop - 1996)